home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 008 / flicker.arc / FLICKER.DOC < prev    next >
Encoding:
Text File  |  1986-07-29  |  64.1 KB  |  2,037 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                            F L I C K E R
  21.  
  22.                                             Version 2.1
  23.  
  24.                                       ________________________
  25.                                      |                        |
  26.                                      | A SOFTWARE PACKAGE FOR |
  27.                                      | PRESENTATION  GRAPHICS |
  28.                                      |________________________|
  29.  
  30.  
  31.                                                  by
  32.  
  33.                                            Brian J. Dooley
  34.  
  35.  
  36.  
  37.                                          -- Documentation --
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                     Copyright 1985, 1986 by Brian J. Dooley. All Rights Reserved.
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                     Table of Contents
  120.  
  121.  
  122.                       Introduction..................................2
  123.  
  124.                       Previous Versions.............................2
  125.  
  126.                       Overview......................................2
  127.  
  128.                       Starting the Program..........................3
  129.  
  130.                       Processing Modes..............................5
  131.                        Modes........................................5
  132.                         Command Line................................5
  133.                         Run.........................................5
  134.                          File Format................................5
  135.                          Break Key..................................5
  136.                         Edit Mode...................................5
  137.                          Edit Keys..................................6
  138.                          Function Keys..............................6
  139.                          Box Edit Mode..............................6
  140.                         Work Screen.................................6
  141.  
  142.                       Colors........................................7
  143.  
  144.                       The Commands..................................7
  145.                        Controls ....................................8
  146.                         @LABEL......................................8
  147.                         CHAIN.......................................8
  148.                         DELAY.......................................8
  149.                         FRAME.......................................8
  150.                         GOSUB.......................................8
  151.                         LOOP........................................8
  152.                         ONKEY.......................................8
  153.                         RETURN......................................9
  154.                        File Routines................................9
  155.                         SQUEEZE.....................................9
  156.                         UNSQUEEZE...................................9
  157.                         WRITE.......................................9
  158.                        Music .......................................9
  159.                         PLAY........................................9
  160.                        Screen......................................10
  161.                         CLEAR......................................10
  162.                         COLOR......................................10
  163.                         DOWN.......................................10
  164.                         LEFT.......................................10
  165.                         MERGE......................................10
  166.                         REVERSE....................................10
  167.                         RIGHT......................................10
  168.                         SHOW.......................................10
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                         UP.........................................11
  175.                         WINDOW.....................................11
  176.                         ZOOM.......................................11
  177.                        Screen Write................................11
  178.                         BOX........................................11
  179.                         CIRCLE.....................................11
  180.                         CUT........................................11
  181.                         LINE.......................................11
  182.                         PASTE......................................12
  183.                         PATTERN....................................12
  184.                        Text Entry .................................12
  185.                         C=.........................................12
  186.                         T=.........................................12
  187.                         TD=........................................12
  188.                         TEXT.......................................12
  189.                         FONT.......................................12
  190.                        Wipes ......................................13
  191.                         CENTEROUT..................................13
  192.                         DIAGONAL...................................13
  193.                         DISSOLVE...................................13
  194.                         WIPE.......................................13
  195.  
  196.                       Capabilities ................................14
  197.                        Use in Different Environments...............14
  198.                         In-Store Displays..........................14
  199.                         Business Presentations.....................15
  200.                         Training Presentations.....................15
  201.                        Effects.....................................16
  202.                         Animation..................................16
  203.                         Banners....................................16
  204.                         Text and Characters........................17
  205.                        Sequence Planning...........................17
  206.                         Presentation Frames........................17
  207.  
  208.                       Care in Preparation..........................18
  209.  
  210.                       Technical Notes .............................18
  211.  
  212.                       User Supported Software......................18
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.           FLICKER Documentation                                    by Brian J. Dooley
  229.  
  230.  
  231.  
  232.  
  233.            I n t r o d u c t i o n
  234.  
  235.           The FLICKER program is a command file processor for graphics
  236.           presentations. It is provided on an as-is basis through the
  237.           user-supported software concept, as described later in this
  238.           manual. No warranties, either expressed or implied, are made
  239.           regarding the functioning of this product in a given setting.
  240.  
  241.           To use this software, you need the following equipment:
  242.  
  243.                An IBM PC or close compatible
  244.                128K+ memory
  245.                A Graphics Board and suitable monitor
  246.  
  247.           The following accessories will make this program more useful:
  248.  
  249.                A word-processing program capable of generating ASCII text
  250.                A graphics creation program capable of creating binary
  251.           image files.
  252.  
  253.            P r e v i o u s   V e r s i o n s
  254.  
  255.           Those who have participated in the development of this program
  256.           will recognize it as PRESENT. A name change became necessary
  257.           when it was found that another user-supported software package
  258.           with that name was being uploaded to BBS systems shortly after
  259.           this program became available. We hope that the name change has
  260.           not caused any confusion.
  261.  
  262.           You may also find the new name quite appropriate. Version 2 has
  263.           been somewhat long in coming, due to its ambitious specifica-
  264.           tions. The first difference thatyou will note is that the
  265.           program itself is over twice as large! The new, interactive
  266.           edit capability (Edit Mode) makes it much easier to set
  267.           parameters for screen placement and also makes it a treat to
  268.           build screens with the new drawing and text commands; not only
  269.           can you "unerase", but you can go back and alter the drawing
  270.           commands themselves before creating a file.
  271.  
  272.           For the most part, FLICKER is compatible with PRESENT 1. Line
  273.           numbers may be used in place of labels in files, for example.
  274.           Check your syntax, though. And, while you're at it, check out
  275.           the many new commands.
  276.  
  277.  
  278.  
  279.                                       -- 1 --
  280.  
  281.  
  282.  
  283.           FLICKER Documentation                                    by Brian J. Dooley
  284.  
  285.  
  286.  
  287.  
  288.  
  289.            O v e r v i e w
  290.  
  291.           The FLICKER program is a graphics command processor. Its
  292.           primary function is to provide a means for creating sequences
  293.           of images and sound that may be used for store displays, for
  294.           instruction, or for business (or other) presentations. In its
  295.           current form, the program does contain limited facilities for
  296.           creation of image files. These features augment the basic dis-
  297.           play functions to create interesting effects not possible in
  298.           most "slideshow" presentation systems.
  299.  
  300.           FLICKER reads image files which have been created using the
  301.           popular BSAVE
  302.           format, as specified in Microsoft Basic. Many graphics packages
  303.           capable of
  304.           creating and saving graphics in this format exist; to date,
  305.           there have been few attempts to create a system for using these
  306.           files in a sophisticated
  307.           presentation. FLICKER can also compress files to save space,
  308.           and these files can be read with ordinary processing commands.
  309.  
  310.           The functions of FLICKER are more easily understood when com-
  311.           pared with a slide show. In this context, the ordinary graphics
  312.           program is the camera--it creates a slide, consisting of a
  313.           single image. FLICKER acts as a projector, allowing these
  314.           slides to be linked together in a single presentation.
  315.  
  316.           FLICKER allows you to be creative after your images have been
  317.           made. Functions that are supported include the following:
  318.  
  319.                     Interactive Edit--you can create your FLICKER scripts
  320.           and execute
  321.                     them at the same time.
  322.  
  323.                     Limited Animation--rapid movement between screens can
  324.           make the
  325.                     image appear to be animated.
  326.  
  327.                     Zoom Capability--you can zoom in on any area of the
  328.           screen, en
  329.                     larging it to 2x its original size.
  330.  
  331.  
  332.  
  333.  
  334.                                       -- 2 --
  335.  
  336.  
  337.  
  338.           FLICKER Documentation                                    by Brian J. Dooley
  339.  
  340.  
  341.  
  342.                     Windowing--you can shrink an image to half its size
  343.           and place it
  344.                     on the screen in any location; in fact, you can place
  345.           as many
  346.                     such reduction windows on a screen as you want.
  347.  
  348.                     Merge--you can merge two graphics screens into each
  349.           other, to
  350.                     create an overlay effect.
  351.  
  352.                     Horizontal Scroll--you can scroll left or right to
  353.           create banner-
  354.                     like effects.
  355.  
  356.                     Vertical Scroll--you can scroll up or down to present
  357.           a con
  358.                     tinuously rolling "sheet".
  359.  
  360.                     Looping--you can create loops of a given number of
  361.           passes (like
  362.                     FOR--NEXT in Basic).
  363.  
  364.                     Key Trapping--you can make a given action dependent
  365.           upon the
  366.                     operator's pressing of a key.
  367.  
  368.                     Full Color Flexibility--you can change background
  369.           colors and
  370.                     foreground palettes at will.
  371.  
  372.                     Frame Sequencing--you can create sequences (including
  373.           action)
  374.                     which can be switched forward and backwards on key.
  375.  
  376.                     Reverse--you can reverse the background and
  377.           foreground colors.
  378.  
  379.                     Text entry--from within your command file, or from a
  380.           separate AS
  381.                     CII text file, in several different typestyles.
  382.  
  383.                     Drawing--you can actually draw lines, circles and
  384.           boxes on screen
  385.                     from your command file.
  386.  
  387.  
  388.  
  389.                                       -- 3 --
  390.  
  391.  
  392.  
  393.           FLICKER Documentation                                    by Brian J. Dooley
  394.  
  395.  
  396.  
  397.  
  398.                     Wipes and Patterns--you can create interesting color
  399.           textures on
  400.                     screen, and have the new screen open out from the
  401.           sides, top,
  402.                     diagonal, or center.
  403.  
  404.                     Cut and Paste--you can cut parts of screens, save
  405.           them, and paste
  406.                     them onto other screens for animated effects. This
  407.           can all be
  408.                     done from within your command file.
  409.  
  410.                     Chaining, subroutines...and more--now you can keep a
  411.           library of
  412.                     effects, and draw it into your present program...or
  413.           reuse effects
  414.                     within your program.
  415.  
  416.  
  417.           These effects are all obtainable because FLICKER allows you to
  418.           create the
  419.           program. It operates on a text "script" that you create by
  420.           using a simple and easily understandable 'language'. The script
  421.           can easily be changed through the interactive edit capabilities
  422.           provided, or through use of any ASCII text editor. The new, in-
  423.           teractive edit capability allows you to create screens and test
  424.           them from within the program itself--then write them to command
  425.           files that will run when you run the program.
  426.  
  427.  
  428.            S t a r t i n g   t h e   P r o g r a m
  429.  
  430.           There are several methods for starting and using FLICKER, as
  431.           described under the various available operating modes. The
  432.           basic method is to call the program from DOS. To run the demo,
  433.           place the FLICKER disk in your A drive. Enter FLICKER DEMO at
  434.           the A> prompt. The demo will run from the Demo command file
  435.           from start to stop, then return to DOS. This this will provide
  436.           a good overview of the program. To create your own command
  437.           files and screens, however, you need to get to the Edit screen.
  438.  
  439.           From DOS, enter FLICKER. This will call the "WorkScreen" to ap-
  440.           ppear. The
  441.  
  442.  
  443.  
  444.                                       -- 4 --
  445.  
  446.  
  447.  
  448.           FLICKER Documentation                                    by Brian J. Dooley
  449.  
  450.  
  451.  
  452.           WorkScreen is FLICKER's basic entry screen; it is used to move
  453.           between edit and run modes, and obtain directories. Get the
  454.           directory of your A drive, and check to see that you have
  455.           FLICKER.HLP available. Now, type E. This will bring you into
  456.           the Edit mode. The Edit mode is easy to recognize because it
  457.           has a number (1, in this case) on the lower left edge of the
  458.           screen, and a question mark followed by a dash on the second
  459.           last line. This is the command line; the dash is a partial cur-
  460.           sor.
  461.  
  462.           Now, press the F1 key. This will call the help screen. Since no
  463.           commands have been entered, the screen showing the command list
  464.           and keys will appear. Pressing any key will now return you to
  465.           where you were in the Edit Mode.
  466.  
  467.           Try typing a command such as SHOW PIC1. Press the return
  468.           (enter) key. The
  469.           FLICKER logo screen will appear, and the instruction pointer in
  470.           the lower left corner will display a two. Now enter WINDOW.
  471.           Press the F1 key, and you will see a complete description of
  472.           how the WINDOW command is used. Press any key to continue.
  473.  
  474.           You should now be back in the Edit Mode, with the WINDOW com-
  475.           mand showing.
  476.           WINDOW is a command that permits use of the Box Edit mode to
  477.           accurately place your images. Press the F4 key. A large rec-
  478.           tangle will appear; you can move this to the location where you
  479.           want the image to appear with the cursor keys. Now, press the
  480.           'C' character key. The box marker will change color. This is
  481.           useful when you are working on a screen that is mostly in a
  482.           single foreground color. When you have found a suitable loca-
  483.           tion, press F4 again. Numbers will appear after WINDOW, accord-
  484.           ing to the syntax of that command. Press enter, and the current
  485.           screen image will be reduced and placed in that location.
  486.  
  487.           Some Box Edit commands (CUT and the drawing commands) require
  488.           another press of the F4 key. In these cases, you select one
  489.           location by moving the marker to the first location, press F4,
  490.           and move a second marker to a second location. Pressing F4 a
  491.           third time then returns you to the Command Line as before.
  492.  
  493.           Press the F9 key--the previous command entered will appear. You
  494.           can advance to the next command with the F10 key. The F7 key
  495.           deletes the current line; the F8 key inserts a new line. The F6
  496.  
  497.  
  498.  
  499.                                       -- 5 --
  500.  
  501.  
  502.  
  503.           FLICKER Documentation                                    by Brian J. Dooley
  504.  
  505.  
  506.  
  507.  
  508.           In using this processor, you will find that the capability to
  509.           go back a few
  510.           lines and manually change parameters is most helpful. You can
  511.           also use the
  512.           CHAIN command within edit mode, providing a simple method of
  513.           maintaining a
  514.           library of drawings.
  515.  
  516.           Other useful keys within the edit mode are the Pg Up, Pg Dn,
  517.           Home, and End keys on the cursor pad. Pg Up copies a command
  518.           line, and Pg Dn places it. This permits multiple entries of a
  519.           single command; simply type in the command, enter it, and press
  520.           Pg Dn to copy it to the next line.
  521.  
  522.           Pressing the Home key results in a request for a line number to
  523.           go to. This is chiefly useful when dealing with large files.
  524.           The End key erases the current screen.
  525.  
  526.           Commands can be entered and saved in memory without execution
  527.           by pressing the Ctrl (control) key and, while it is still down,
  528.           pressing the enter key. This will also move you to the next
  529.           line for further commnd entry. Command files can be read and
  530.           written within the Edit Mode by using the F6 and F2 keys. When
  531.           you press F2, you will be prompted with a request for a command
  532.           file to be read. Enter Demo. The Demo file will now be in
  533.           memory. You can work with this file, making changes with the
  534.           bottom function keys (F7,F8,F9,F10) and entering new commands.
  535.           To save the new (changed) file, press the F5 key. You will be
  536.           prompted for the name of the file to be written. Enter demo2.
  537.           You have now created a FLICKER script, which may be used just
  538.           as you originally called the Demo file from DOS; or, you may
  539.           return to the WorkScreen and run it by specifying Run; or, you
  540.           can run it directly from the Edit Mode by pressing F6. F6 is
  541.           generally used to check command files before writing them to
  542.           memory, so that you can make any necessary changes.
  543.  
  544.           To leave the Edit Mode, press the Control key (Ctrl). Withou
  545.           releasing this
  546.           key, press the END key (the '1' key on the numeric keypad).
  547.           Since you started FLICKER from the WorkScreen, this will return
  548.           you to the WorkScreen. From the WorkScreen, you can return to
  549.           DOS by typing 'Q'; run a command file by pressing 'R'; obtain a
  550.           directory by entering 'D' followed by the size (s) or time (t)
  551.  
  552.  
  553.  
  554.                                       -- 6 --
  555.  
  556.  
  557.  
  558.           FLICKER Documentation                                    by Brian J. Dooley
  559.  
  560.  
  561.  
  562.  
  563.  
  564.            P r o c e s s i n g   M o d e s
  565.  
  566.  
  567.           FLICKER is equipped with a variety of processing modes that
  568.           provide the user with considerable flexibility in creating and
  569.           executing scripts. The basic modes are Command Line, Work
  570.           Screen, Run and Edit. Command Line processing generally
  571.           provides faster processing, and is suitable for short command
  572.           sequences or to make quick changes in a file. The Work Screen
  573.           mode is the "normal" mode; it permits movement to Run and Edit
  574.           modes, provides various services, and retains files in memory
  575.           after processing. The Run mode is actually a variation of the
  576.           Command Line mode, and described in that section--it is used
  577.           for final execution of a program file; it processes the file
  578.           and simply returns to DOS. The Edit mode permits you to change
  579.           and execute program files in memory.
  580.  
  581.                Modes
  582.  
  583.                     Command Line
  584.  
  585.                     Several processing types can be specified at the com-
  586.           mand
  587.                     line (from DOS) by making entries after the program
  588.           name:
  589.                     FLICKER filename : Runs a command file immediately.
  590.                     FLICKER *EDIT    : Opens program in Edit Mode.
  591.                     FLICKER *command;command : Executes commands (128
  592.           chars).
  593.                     -ALL Command Line options return to DOS; no file is
  594.           created.
  595.  
  596.                     Run
  597.  
  598.  
  599.                     Run Mode may be specified from the Command Line
  600.           (FLICKER
  601.                     filename) or from the Work Screen. In this mode, the
  602.           command
  603.                     file is simply processed as-is.
  604.  
  605.                            File Format
  606.  
  607.  
  608.  
  609.                                       -- 7 --
  610.  
  611.  
  612.  
  613.           FLICKER Documentation                                    by Brian J. Dooley
  614.  
  615.  
  616.  
  617.  
  618.  
  619.                          All FLICKER command files are straight ASCII
  620.           text. Nor
  621.                           mally, commands are entered one per line, in
  622.           upper or
  623.                          lower case letters. For files used in the Run
  624.           Mode, it is
  625.                           also possible to separate commands with a semi-
  626.           colon--
  627.                          except after the last entry on a line. This is
  628.           par
  629.                          ticularly convenient if labels are used (@label;
  630.           show
  631.                          b:filename).
  632.  
  633.                            Break Key
  634.  
  635.  
  636.                            Ctrl-Break key or Control-C halt processing of
  637.           command
  638.                          file.
  639.  
  640.                     Edit Mode
  641.  
  642.                     Edit Mode permits entry, storage and execution of
  643.           commands.
  644.                     A complete set of function keys is provided for these
  645.           func-
  646.                     tions. From Edit Mode, you can move to Box Edit Mode
  647.           to
  648.                     place picture items on screen (F4). Edit Mode dis-
  649.           plays a
  650.                     command entry line near the bottom of the screen. The
  651.           number
  652.                     of the current line is listed directly below.
  653.  
  654.  
  655.                            Edit Keys
  656.  
  657.  
  658.                            The following keys function only in Edit Mode:
  659.  
  660.                            <Return>     : Executes command, rgisters it,
  661.  
  662.  
  663.  
  664.                                       -- 8 --
  665.  
  666.  
  667.  
  668.           FLICKER Documentation                                    by Brian J. Dooley
  669.  
  670.  
  671.  
  672.                                            to next line if not FRAME,
  673.           ONKEY, or
  674.                                       GOSUB.
  675.                            <Ctrl-Return>: Registers command without ex-
  676.           ecuting, moves
  677.                                       to next.
  678.                            <Ctrl-End>   : Exits to Work Screen if in
  679.           Workscreen
  680.                                       mode, or to DOS if Edit Mode was
  681.           entered
  682.                                       from DOS.
  683.                            <INS>        : Inserts characters without
  684.           overwrite
  685.                                      (toggle).
  686.                            <DEL>        : Deletes character at current
  687.           position.
  688.                                       cursor right, left : Move edit
  689.           position on
  690.                                       line.
  691.                            <Backspace>  : Deletes characters backwards.
  692.                            C key        : in Box Edit, changes box color
  693.           on press of
  694.                                           cursor keys.
  695.                            Function Keys
  696.  
  697.                            The following function keys are active in Edit
  698.           Mode:
  699.  
  700.                            F1  : Help                      F2  : Read
  701.           Command File
  702.                            F3  : Clear Memory              F4  : Box Edit
  703.           switch
  704.                            F5  : Write Memory to File      F6  : Run File
  705.           in Memory
  706.                            F7  : Delete Current Line       F8  : Insert
  707.           Line
  708.                            F9  : Go to Previous Line       F10 : Go to
  709.           Next Line
  710.                            <Home>  : Go To Line          <End> : Clear
  711.           Screen
  712.                            <Pg Up> : Copy Line          <Pg Dn>: Place
  713.           Copy
  714.                            <Ins>   : Box Cursor Toggle (Box Mode Only 1-
  715.           10)
  716.  
  717.  
  718.  
  719.                                       -- 9 --
  720.  
  721.  
  722.  
  723.           FLICKER Documentation                                    by Brian J. Dooley
  724.  
  725.  
  726.  
  727.  
  728.                            Box Edit Mode
  729.  
  730.                                Box Edit operates within the Edit Mode,
  731.           when F4 is
  732.                          pressed and the command line contains one of the
  733.                          following: CUT, PASTE, WINDOW, ZOOM, BOX,
  734.           CIRCLE, LINE,
  735.                          T=, TD=, C=. A box of the appropriate side ap-
  736.           pears in the
  737.                          upper left corner. This may be moved by cursor
  738.           keys
  739.                          (including diagonals). Toggle the Box Cursor be-
  740.           tween 1
  741.                          and 10 with the <Ins> key.  For some commands,
  742.           two loca
  743.                          tions are specified (switch with F4). When the
  744.                          location(s) have been marked on the screen, F4
  745.           is
  746.                               pressed again. This places the appropriate
  747.           parameters on
  748.                          the command line for entry (or further editing)
  749.           in Edit
  750.                          Mode. Only the first part of the command need be
  751.           typed
  752.                          before pressing F4 : t=Flicker <F4> places x/y
  753.           parameters
  754.                          on command line--T=FLICKER 20/20--according
  755.           location in
  756.                          dicated.
  757.  
  758.                     Work Screen
  759.  
  760.  
  761.                     The Work Screen is the normal first screen if FLICKER
  762.           is run
  763.                     without command line parameters. This screen provides
  764.           direc-
  765.                     tory services with size and time (s, t, st, or
  766.           nothing). If
  767.                     Work Screen Mode is on (i.e., you started from this
  768.           screen),
  769.                     termination (end of file, Ctrl-End, or Ctrl-Break)
  770.           return
  771.  
  772.  
  773.  
  774.                                       -- 10 --
  775.  
  776.  
  777.  
  778.           FLICKER Documentation                                    by Brian J. Dooley
  779.  
  780.  
  781.  
  782.                     to Work Screen, with current file in memory.
  783.  
  784.  
  785.            C o l o r s
  786.  
  787.           Many of the commands used in FLICKER make reference to numbers
  788.           specifying
  789.           color palettes and foreground and background colors. The num-
  790.           bers used corre
  791.           spond to the normal PC color scheme of four palettes specifying
  792.           foreground
  793.           groups of 4 colors each, and 16 background colors.  Following
  794.           are all color codes available:
  795.  
  796.                Palette     Foreground Codes
  797.  
  798.           ---------------------------------------------------------------
  799.           --------
  800.                          0         1              2              3
  801.  
  802.           --------------------------------------------------------
  803.                0    Background     Green               Red
  804.           Brown
  805.                1         "    Cyan           Magenta        Light Gray
  806.                2         "    Light Green         Light Red      Yellow
  807.                3         "    Light Cyan          Light Magenta  White
  808.  
  809.           ---------------------------------------------------------------
  810.           ---------
  811.  
  812.  
  813.                Background Codes
  814.  
  815.                0  Black       1  Blue        2  Green       3  Cyan
  816.                4  Red         5  Magenta          6  Brown       7  Light
  817.           Gray
  818.                8  Dark Gray   9  Light Blue  10 Light Green 11 Light Cyan
  819.                12 Light Red   13 Lgt Magenta      14 Yellow      15 White
  820.  
  821.                Table 1. Standard Color Codes
  822.  
  823.  
  824.           When a single color is specified, it is generally the
  825.           foregound. The actual color produced by the code is dependent
  826.  
  827.  
  828.  
  829.                                       -- 11 --
  830.  
  831.  
  832.  
  833.           FLICKER Documentation                                    by Brian J. Dooley
  834.  
  835.  
  836.  
  837.  
  838.  
  839.            T h e   C o m m a n d s
  840.  
  841.  
  842.           In all cases, upper or lower case characters may be used. Each
  843.           command must be placed on a separate line, followed by up to
  844.           two parameters. A single space suffices to separate parameters
  845.           and commands.
  846.  
  847.           The FLICKER command set provides a wide variety of functions
  848.           for use in display and creation of presentation graphics
  849.           sequences. For convenience, these commands may be broken down
  850.           into the following general groups:
  851.  
  852.  
  853.                Controls:         Commands that provide program flow con-
  854.           trol, such as
  855.                                  processing halts, delays, subroutines,
  856.           file chain
  857.                               ing, etc.
  858.  
  859.                File Routines:    Commands used to process files and per-
  860.           form such
  861.                               tasks as file writing, file 'squeezing' and
  862.                               'unsqueezing'.
  863.  
  864.                Music:            Commands used to play music files from
  865.           FLICKER.
  866.  
  867.                Screen:           Commands used for processing screens,
  868.           such as
  869.                                  directional movement, merge, reverse,
  870.           etc.
  871.  
  872.                Screen Write:     Commands used to draw boxes, lines and
  873.           circles and
  874.                                  create patterns on screen.
  875.  
  876.                Text Entry:       Commands used to enter text or charac-
  877.           ters on the
  878.                               screen, either directly, or from files.
  879.  
  880.                Wipes:            Commands used to bring new screens into
  881.  
  882.  
  883.  
  884.                                       -- 12 --
  885.  
  886.  
  887.  
  888.           FLICKER Documentation                                    by Brian J. Dooley
  889.  
  890.  
  891.  
  892.                               a wiping motion (i.e., rather than moving
  893.           the old
  894.                               screen out).
  895.  
  896.           All of these commands and functions are described alphabeti-
  897.           cally below for
  898.           convenience.
  899.  
  900.  
  901.           ---------------------------------------------------------------
  902.           ------
  903.  
  904.            Controls
  905.  
  906.                @LABEL
  907.  
  908.                Syntax : @label
  909.  
  910.                Used with ONKEY, LOOP, GOSUB commands. A label is placed
  911.                on line to indicate a processing location (@thisplace).
  912.  
  913.                CHAIN
  914.  
  915.                Syntax : chain filename
  916.  
  917.                Transfers control to chained command file, then returns
  918.                to next line. This allows previously created routines
  919.                to be called from within command file.
  920.  
  921.  
  922.                DELAY
  923.  
  924.                Syntax : delay n
  925.  
  926.                Halts processing for n milliseconds.
  927.  
  928.  
  929.                FRAME
  930.  
  931.                Syntax : frame
  932.  
  933.                Halts display until + or - keys are hit. The + key con-
  934.           tinues
  935.                processing at next line; the - key resumes processing at
  936.  
  937.  
  938.  
  939.                                       -- 13 --
  940.  
  941.  
  942.  
  943.           FLICKER Documentation                                    by Brian J. Dooley
  944.  
  945.  
  946.  
  947.                line after previous frame command. This command is used to
  948.                create 'slide sequences' (which may include action) that
  949.                can be reviewed or move forward.
  950.  
  951.  
  952.                GOSUB
  953.  
  954.                Syntax : gosub @label
  955.  
  956.                Goes to subroutine referenced by label, and returns to
  957.           next
  958.                line when RETURN command is encountered.
  959.  
  960.  
  961.                LOOP
  962.  
  963.                Syntax : loop @label n
  964.  
  965.                Actually, a goto statement. Line number may be substituted
  966.                for label. Processing returns to indicated line, n times
  967.           if
  968.                n parameter is included (otherwise, always).
  969.  
  970.                ONKEY
  971.  
  972.                Syntax : onkey  @label p
  973.  
  974.                A line number may be substitute for label. Any ASCII
  975.           string
  976.                prefaced by @ can be used as a label, and placed on line
  977.           to
  978.                move to. Default without label or line number holds pro-
  979.                cessing until parameter (letter) key is pressed. With line
  980.                number or label, processing moves to indicated line if
  981.                letter, and there is no hold (i.e., must be used in loop).
  982.                Use of ONKEY with no parameters holds till any key is
  983.           pressed.
  984.  
  985.                RETURN
  986.  
  987.                Syntax : return
  988.  
  989.                Returns processing to next line at end of subroutine
  990.                (GOSUB command).
  991.  
  992.  
  993.  
  994.                                       -- 14 --
  995.  
  996.  
  997.  
  998.           FLICKER Documentation                                    by Brian J. Dooley
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.           ---------------------------------------------------------------
  1005.           ------
  1006.  
  1007.           File Routines
  1008.  
  1009.                SQUEEZE
  1010.  
  1011.                Syntax : squeeze filename1 filename2
  1012.  
  1013.                Compresses file1 (filename1) and places results in file2
  1014.                (filename2).
  1015.  
  1016.  
  1017.  
  1018.                UNSQUEEZE
  1019.  
  1020.                Syntax : unsqueeze filename1 filename2
  1021.  
  1022.                Takes compressed file1 (filename1) and expands it to nor-
  1023.           mal
  1024.                picture file size, placing the result in file2
  1025.           (filename2).
  1026.                All picture file commands (SHOW, LEFT, etc.) recognize
  1027.                squeezed files and process them to screen, but there is a
  1028.                delay for processing.
  1029.  
  1030.  
  1031.                WRITE
  1032.  
  1033.                Syntax : write filename
  1034.  
  1035.                Writes current screen to file indicated by filename.
  1036.  
  1037.  
  1038.           ---------------------------------------------------------------
  1039.           ------
  1040.           Music
  1041.  
  1042.                PLAY
  1043.  
  1044.                Syntax : play filename
  1045.  
  1046.  
  1047.  
  1048.  
  1049.                                       -- 15 --
  1050.  
  1051.  
  1052.  
  1053.           FLICKER Documentation                                    by Brian J. Dooley
  1054.  
  1055.  
  1056.  
  1057.                Plays music file (filename). Processing does not continue
  1058.                while music plays. Files can be created with BLUES public
  1059.                domain music program.
  1060.  
  1061.                If a music file generator is not available, an ASCII file
  1062.                with the following format will do:
  1063.  
  1064.                1 note per line, followed by a return.
  1065.  
  1066.                 tempo  duration (inverse)
  1067.                 / /    //
  1068.                12345678901
  1069.                     \    \\
  1070.                      \    note, and suffix (A#,Ab)
  1071.                    octave
  1072.                     (1-8)
  1073.  
  1074.  
  1075.  
  1076.  
  1077.           ---------------------------------------------------------------
  1078.           ------
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.           Screen
  1085.  
  1086.                CLEAR
  1087.  
  1088.                Syntax : clear
  1089.  
  1090.                Clears current screen and all screen buffers.
  1091.  
  1092.  
  1093.                COLOR
  1094.  
  1095.                Syntax : color n m
  1096.  
  1097.                Turns on palette n, background color m. Changes colors of
  1098.                current screen.
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.                                       -- 16 --
  1105.  
  1106.  
  1107.  
  1108.           FLICKER Documentation                                    by Brian J. Dooley
  1109.  
  1110.  
  1111.  
  1112.                DOWN
  1113.  
  1114.                Syntax : down filename
  1115.  
  1116.                Moves the specified file (filename) onto the screen from
  1117.           the
  1118.                top while moving the existing screen off the bottom. Use-
  1119.           ful
  1120.                for creating moving banners.
  1121.  
  1122.  
  1123.                LEFT
  1124.  
  1125.                Syntax : left filename
  1126.  
  1127.                Moves the specified file (filename) onto the screen from
  1128.           the
  1129.                right, while moving the existing screen off the left. Use-
  1130.           ful
  1131.                for creating moving banners.
  1132.  
  1133.  
  1134.                MERGE
  1135.  
  1136.                Syntax : merge filename
  1137.  
  1138.                Merges file (filename) into current screen, using logical
  1139.                OR statements.
  1140.  
  1141.  
  1142.                REVERSE
  1143.  
  1144.                Syntax : reverse
  1145.  
  1146.                Takes current screen and reverses all colors.
  1147.  
  1148.  
  1149.                RIGHT
  1150.  
  1151.                Syntax : right filename
  1152.  
  1153.                Moves the specified file (filename) onto the screen from
  1154.           the
  1155.                left, while moving the existing screen off the right. Use-
  1156.  
  1157.  
  1158.  
  1159.                                       -- 17 --
  1160.  
  1161.  
  1162.  
  1163.           FLICKER Documentation                                    by Brian J. Dooley
  1164.  
  1165.  
  1166.  
  1167.                for creating moving banners.
  1168.  
  1169.  
  1170.                SHOW
  1171.  
  1172.                Syntax : show filename n
  1173.  
  1174.                Brings file (filename) onto screen, holding it there for n
  1175.                milliseconds in addition to processing time. Default, with
  1176.                n not entered, is 2000 (2 seconds).
  1177.  
  1178.  
  1179.  
  1180.  
  1181.                UP
  1182.  
  1183.                Syntax : up filename
  1184.  
  1185.                Moves the specified file (filename) onto the screen from
  1186.           the
  1187.                bottom, while moving the existing screen off the top. Use-
  1188.           ful
  1189.                for creating moving banners.
  1190.  
  1191.  
  1192.                WINDOW
  1193.  
  1194.                Syntax : window filename x/y
  1195.  
  1196.                Shrinks file (filename) to one half its size, and places
  1197.                results in quarter of current screen whose upper left hand
  1198.                corner is x/y.
  1199.  
  1200.                window x/y  (no filename) shrinks current screen and
  1201.           places
  1202.                it at specific location in current screen.
  1203.  
  1204.  
  1205.                ZOOM
  1206.  
  1207.                Syntax : zoom filename x/y
  1208.  
  1209.                Expands the quarter of file (filename) whose upper left
  1210.                corner is at location x/y (i.e., 10/20), and writes
  1211.  
  1212.  
  1213.  
  1214.                                       -- 18 --
  1215.  
  1216.  
  1217.  
  1218.           FLICKER Documentation                                    by Brian J. Dooley
  1219.  
  1220.  
  1221.  
  1222.                to the screen.
  1223.  
  1224.                zoom x/y (no filename) zooms current screen from location
  1225.                specified and writes result to current screen.
  1226.  
  1227.  
  1228.           ---------------------------------------------------------------
  1229.           ------
  1230.  
  1231.           Screen Write
  1232.  
  1233.                BOX
  1234.  
  1235.                Syntax : boxn x1/y1 x2/y2
  1236.  
  1237.                Writes box on screen in color indicated by n (box1=color
  1238.           1),
  1239.                where x1/y1 is the upper left corner, and x2/y2 is lower
  1240.                right corner (360 x 200 matrix).
  1241.  
  1242.  
  1243.                CIRCLE
  1244.  
  1245.                Syntax : circlen x1/y1 x2/y2
  1246.  
  1247.                Writes circle on screen in color indicated by n (circle1 =
  1248.                color 1) where x1/y1 is the upper left, and x2/y2 is lower
  1249.                right end of circle's diameter (360 x 200 matrix).
  1250.  
  1251.                CUT
  1252.  
  1253.                Syntax : cut filename x1/y1/x2/y2
  1254.  
  1255.                Cuts a portion from current screen, with upper left corner
  1256.                at x1/y1 and lower right at x2/y2. Writes result to file
  1257.                (filename). Cut files are retrieved only with PASTE com-
  1258.           mand.
  1259.                Uses 80 x 100 matrix.
  1260.  
  1261.  
  1262.                LINE
  1263.  
  1264.                Syntax : linen x1/y1 x2/y2
  1265.  
  1266.  
  1267.  
  1268.  
  1269.                                       -- 19 --
  1270.  
  1271.  
  1272.  
  1273.           FLICKER Documentation                                    by Brian J. Dooley
  1274.  
  1275.  
  1276.  
  1277.                Writes line on screen in color indicated by n (line1 =
  1278.                color 1) where x1/y1 is the upper left, and x2/y2 is lower
  1279.                right (360 x 200 matrix).
  1280.  
  1281.  
  1282.                PASTE
  1283.  
  1284.                Syntax : paste filename x/y
  1285.  
  1286.                Paste file (filename) formerly created with CUT command to
  1287.                location pointed to by x/y (upper left corner). Uses 80 x
  1288.                100 matrix.
  1289.  
  1290.                PATTERN
  1291.  
  1292.                Syntax : pattern nnnn mmmm
  1293.  
  1294.                Writes pattern of colors to screen, where each parameter
  1295.           (m,
  1296.                n) is a color between 0 and 3. Patterns are on alternate
  1297.                lines, across screen (n above) as follows:
  1298.                pattern 1203 3132 = 1203120312031203...
  1299.                                    3132313231323132... (colors)
  1300.  
  1301.  
  1302.           ---------------------------------------------------------------
  1303.           ------
  1304.           Text Entry
  1305.  
  1306.                C=
  1307.  
  1308.                Syntax : c=n m x/y
  1309.  
  1310.                Writes ASCII character number n to screen at x/y location
  1311.                in color m, at screen location x/y (40 x 25 matrix).
  1312.  
  1313.  
  1314.                T=
  1315.  
  1316.                Syntax : t=word n x/y
  1317.  
  1318.                Writes character string (word) to current screen in color
  1319.           n,
  1320.                left to right from location x/y (40 x 25 matrix).
  1321.  
  1322.  
  1323.  
  1324.                                       -- 20 --
  1325.  
  1326.  
  1327.  
  1328.           FLICKER Documentation                                    by Brian J. Dooley
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.                TD=
  1335.  
  1336.                Syntax : td=word n x/y
  1337.  
  1338.                Works like T= command, only text goes down instead of left
  1339.                to right.
  1340.  
  1341.  
  1342.                TEXT
  1343.  
  1344.                Syntax : text filename n
  1345.  
  1346.                Writes ASCII file (filename) to screen in color n. The
  1347.                text file can be created by any editor producing ASCII
  1348.                format, and should be no more than 40 characters across
  1349.                and 24 lines down.
  1350.  
  1351.  
  1352.                FONT
  1353.  
  1354.                Syntax : font fontname
  1355.  
  1356.                Calls font specified by fontname. When a font is called,
  1357.                text commands write in that font (Text, T=, TD=). Avail-
  1358.                able fonts are NORMAL, SANSERIF, and GOTHIC. Normal calls
  1359.                the standard color graphics character set, and extended
  1360.                characters (over ASCII 128) are available with C=; the
  1361.                other fonts eliminate the special ASCII characters.
  1362.  
  1363.  
  1364.  
  1365.  
  1366.           ---------------------------------------------------------------
  1367.           ------
  1368.  
  1369.  
  1370.           Wipes
  1371.  
  1372.                CENTEROUT
  1373.  
  1374.                Syntax : centerout filename
  1375.  
  1376.  
  1377.  
  1378.  
  1379.                                       -- 21 --
  1380.  
  1381.  
  1382.  
  1383.           FLICKER Documentation                                    by Brian J. Dooley
  1384.  
  1385.  
  1386.  
  1387.                Brings file (filename) into current screen, all directions
  1388.                from center.
  1389.  
  1390.  
  1391.                DIAGONAL
  1392.  
  1393.                Syntax : diagonalp filename
  1394.  
  1395.                Works like WIPE command, only files enter from corners and
  1396.                move in diagonally. The parameter (p) specifies the corner
  1397.                numerically, clockwise from upper left (diagonal1,
  1398.           diagonal2
  1399.                diagonal3, diagonal4).
  1400.  
  1401.  
  1402.                DISSOLVE
  1403.  
  1404.                Syntax : dissolve filename
  1405.  
  1406.                Dissolves current screen, and writes file (filename) to
  1407.                screen.
  1408.  
  1409.  
  1410.                WIPE
  1411.  
  1412.                Syntax : wipeu filename
  1413.  
  1414.                Brings file (filename) into current screen, in direction
  1415.                indicated by parameter (p). The following parameters may
  1416.                be used : U = up, D = down, L = left, R = right (wipeu,
  1417.                wiped, wipel, wiper).
  1418.  
  1419.  
  1420.           ---------------------------------------------------------------
  1421.           ------
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.                                       -- 22 --
  1435.  
  1436.  
  1437.  
  1438.           FLICKER Documentation                                    by Brian J. Dooley
  1439.  
  1440.  
  1441.  
  1442.  
  1443.            C a p a b i l i t i e s
  1444.  
  1445.           Use in Different Environments
  1446.  
  1447.           FLICKER contains special features for use in specific environ-
  1448.           ments. In writing a FLICKER script, you should focus upon the
  1449.           types of effects that will be most useful in the intended con-
  1450.           text.
  1451.  
  1452.           In-Store Displays
  1453.  
  1454.           Store displays using FLICKER can be particularly effective. In
  1455.           this
  1456.           environment, the loop command is particularly useful. A com-
  1457.           plete script can be written using the absolute looping function
  1458.           (LOOP 1) at the end. Once the presentation is finished, it will
  1459.           then begin again at the first line, and run continuously.
  1460.           Within the absolute loop, numbered loops can be used to provide
  1461.           animation, or to repeat information screens.
  1462.  
  1463.           An in-store display for a software store, for example, might
  1464.           begin with a
  1465.           banner identifying the store:
  1466.  
  1467.                     show file1 0
  1468.                     left file2
  1469.                     left file3
  1470.  
  1471.           It might then go on to show a screen depicting the names of
  1472.           popular products available in the store:
  1473.  
  1474.                     show file4
  1475.                     show file5
  1476.  
  1477.           The last screen could be emphasized through rapid shifts
  1478.           through colors and
  1479.           backgrounds:
  1480.  
  1481.                     color 5 3
  1482.                     delay 100
  1483.                     color 4 2
  1484.                     delay 100
  1485.                     color 0 1
  1486.  
  1487.  
  1488.  
  1489.                                       -- 23 --
  1490.  
  1491.  
  1492.  
  1493.           FLICKER Documentation                                    by Brian J. Dooley
  1494.  
  1495.  
  1496.  
  1497.  
  1498.           Pictures of various product types (icons) could be shown in the
  1499.           four quadrants of a screen; each quadrant could then be zoomed
  1500.           for emphasis:
  1501.  
  1502.                     show file6
  1503.                     zoom 0 0
  1504.                     zoom 40 0
  1505.                     zoom 0 50
  1506.                     zoom 40 50
  1507.  
  1508.           An animation effect could then be created to demonstrate, say
  1509.           communications between two terminals using a popular communica-
  1510.           tions package:
  1511.  
  1512.  
  1513.                     @mark
  1514.                     show d:file7 0
  1515.                     show d:file8 0
  1516.                     show d:file9 0
  1517.                     loop @mark 3
  1518.  
  1519.                     (d: is assumed to be a RAM drive, line 16 is the
  1520.           first line in
  1521.                    this sequence)
  1522.  
  1523.           This could be followed by a final screen, some concluding
  1524.           music, and a return to line1 :
  1525.  
  1526.                     show file10 0
  1527.                     play starspang
  1528.                     loop @top
  1529.  
  1530.  
  1531.           Business Presentations
  1532.  
  1533.           Business presentation require a somewhat different type of
  1534.           script. Here, the primary command used is the Frame command.
  1535.           This is important, because it allows review of material covered
  1536.           previously.
  1537.  
  1538.           Most business presentations will also rely heavily upon charts
  1539.           and graphs,
  1540.           which may be created by saving screens from integrated programs
  1541.  
  1542.  
  1543.  
  1544.                                       -- 24 --
  1545.  
  1546.  
  1547.  
  1548.           FLICKER Documentation                                    by Brian J. Dooley
  1549.  
  1550.  
  1551.  
  1552.  
  1553.           A business presentation may begin with a title screen, followed
  1554.           shortly by an extended list of the points to be covered, within
  1555.           a frame context:
  1556.  
  1557.                     frame
  1558.                      show file1
  1559.                      up file2
  1560.                      up file3
  1561.                     frame
  1562.  
  1563.           In this case, file1 contains the introductory material--who is
  1564.           presenting, and what the presentation is about. Files 2 and 3
  1565.           contain points that are to be covered. The presentation begins
  1566.           when the presenter presses the '+' key, and stops with file3 on
  1567.           screen until '+' is pressed again.
  1568.           Next, the presenter may wish to show a chart of business ac-
  1569.           tivities, as created by a business graphics or integrated
  1570.           spreadsheet program. Because these graphs are small, he (or
  1571.           she) may wish to switch to an enlargement--as a separate frame:
  1572.  
  1573.                      show file3
  1574.                     frame
  1575.                      zoom 30,50
  1576.                     frame
  1577.  
  1578.           This allows the audience to view a selected portion of the
  1579.           chart in greater
  1580.           detail. Next, the presenter may wish to show a frame that con-
  1581.           tains an extended bar chart--two screens across:
  1582.  
  1583.                      show file5
  1584.                      left file6
  1585.                      frame
  1586.  
  1587.           The presenter may then wish to reiterate initial points--this
  1588.           time, without the scroll:
  1589.  
  1590.                      show file2
  1591.                     frame
  1592.                      show file3
  1593.                     frame
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.                                       -- 25 --
  1600.  
  1601.  
  1602.  
  1603.           FLICKER Documentation                                    by Brian J. Dooley
  1604.  
  1605.  
  1606.  
  1607.           Of course, colors could be changed during the presentation,
  1608.           specific points
  1609.           could be zoomed in upon (provided they occupied quadrants of
  1610.           the screen), and some animation effects could be used.
  1611.  
  1612.  
  1613.           Training Presentations
  1614.  
  1615.           FLICKER can be particularly useful in training presentations,
  1616.           because it allows actions to be demonstrated on screen, in ad-
  1617.           dition to providing capability to show a set of graphic
  1618.           screens.
  1619.  
  1620.           As with business presentations, training presentations are
  1621.           mainly dependent
  1622.           upon the frame command, which allows switching back and forth
  1623.           between screens. Within training frames, animation effects can
  1624.           be used to demonstrate effects of actions. A helpful feature
  1625.           here is the Onkey command, which allows switching to the next
  1626.           screen--within a frame--either on any key being pressed, or on
  1627.           the pressing of a specific key. Therefore, a demonstration of
  1628.           spreadsheet usage may contain 3 screens, each one
  1629.           showing effects of an action. Present's screen creation is very
  1630.           fast, so
  1631.           pressing a key makes it appear as though that key is directly
  1632.           responsible for an entry on the screen:
  1633.  
  1634.                     frame
  1635.                      show file1 0
  1636.                      onkey
  1637.                      show file2 0
  1638.                      onkey
  1639.                      show file3 0
  1640.                     frame
  1641.  
  1642.           The Onkey command can also be made dependent upon entry of a
  1643.           specific letter, but this feature is only really relevant in
  1644.           special cases--such as in an interactive system, where pressing
  1645.           the letter specifying the correct answer results in continua-
  1646.           tion of the program.
  1647.  
  1648.           Effects
  1649.  
  1650.           Many interesting effects are available through creative use of
  1651.  
  1652.  
  1653.  
  1654.                                       -- 26 --
  1655.  
  1656.  
  1657.  
  1658.           FLICKER Documentation                                    by Brian J. Dooley
  1659.  
  1660.  
  1661.  
  1662.           commands. Some of these effects are built into the system. Fol-
  1663.           lowing are sample scripts to produce special effects.
  1664.  
  1665.  
  1666.           Animation
  1667.  
  1668.           Animation is best done by placing the graphics files that you
  1669.           will be using on a RAM disk; the effect works when floppy or
  1670.           hard disks are used, but it tends to be slow. An animation
  1671.           script appears as follows:
  1672.  
  1673.                       @top
  1674.                       show file1 0
  1675.                       show file2 0
  1676.                       show file3 0
  1677.                       show file4 0
  1678.                       loop @top 10
  1679.  
  1680.  
  1681.           The show commands indicate that each file is to be shown for 0
  1682.           milliseconds; the sequence is then looped through 10 times.
  1683.           Files 1-4 contain images which, when shown rapidly in sequence,
  1684.           create an animation effect. The CUT and PASTE commands can also
  1685.           be used for animation. In this case, CUT the figure, leaving
  1686.           some background space opposite the direction of movement. then,
  1687.           simply paste the figure repeatedly across the screen.
  1688.  
  1689.  
  1690.           Banners
  1691.  
  1692.           Interesting banners of any length can be created. To develop a
  1693.           banner, use your graphics program to write large letters on the
  1694.           screen; take the letters as close as possible to the right edge
  1695.           of the screen and continue the banner on the next screen:
  1696.  
  1697.                        ______  ______  ______
  1698.                       |      ||      ||      |
  1699.                       |   GRA||PHICS ||      |
  1700.                       | PRESE||NTATIO||N     |
  1701.                       |______||______||______|
  1702.                       screen  screen  screen
  1703.                          1       2       3
  1704.  
  1705.           To show the banner, the following script would be used:
  1706.  
  1707.  
  1708.  
  1709.                                       -- 27 --
  1710.  
  1711.  
  1712.  
  1713.           FLICKER Documentation                                    by Brian J. Dooley
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                     show file1 0
  1719.                     left file2
  1720.                     left file3
  1721.  
  1722.           This brings up file1 (screen 1) for the minimal period of time,
  1723.           then scrolls in screens (files) 2 and 3 from right to left.
  1724.  
  1725.  
  1726.           Text and Characters
  1727.  
  1728.           FLICKER provides several interesting ways of entering text.
  1729.           Three fonts, and numerous additional characters are available.
  1730.           If you are in the NORMAL (default) character set, you can
  1731.           access the complete PC ASCII extended character set. Non- al-
  1732.           phabetic characters may be entered by using the C= command, or
  1733.           by specifying the character within the T= command string. In
  1734.           the latter case, the lower ASCII characters can be specified by
  1735.           using a Ctrl-alphabetic key combination, or by using the DOS
  1736.           alt-cursor key combination. The latter method is also useful
  1737.           for entering upper range ASCII characters, including the spe-
  1738.           cial borders. To use the Alt key, first press Alt; while this
  1739.           key is pressed, press keys on the numeric keypad that cor-
  1740.           respond to the number of the character required (Alt 123, for
  1741.           example). Let up the Alt key, and the specified character will
  1742.           appear.
  1743.  
  1744.           The SANSERIF and GOTHIC fonts are provided for use in creating
  1745.           interesting displays. These can be called by using the FONT
  1746.           command. Once a font is specified, it is applied to all text
  1747.           entry routines until the next font is called. When using SAN-
  1748.           SERIF and GOTHIC, the special ASCII characters are not avail-
  1749.           able.
  1750.  
  1751.  
  1752.           Sequence Planning
  1753.  
  1754.           To plan FLICKER sequences, you can write a script that shows
  1755.           several screens at once, through use of the Window command.
  1756.           Thus, the following script:
  1757.  
  1758.                     screen off
  1759.                     show file1
  1760.                     window 0 0
  1761.  
  1762.  
  1763.  
  1764.                                       -- 28 --
  1765.  
  1766.  
  1767.  
  1768.           FLICKER Documentation                                    by Brian J. Dooley
  1769.  
  1770.  
  1771.  
  1772.                     show file2
  1773.                     window 40 1
  1774.                     show file3
  1775.                     window 40 50
  1776.                     show file4
  1777.                     window 0 50
  1778.  
  1779.           This short script places the four screens specified at each
  1780.           quadrant of the
  1781.           screen, in clockwise direction. This feature can aid in plan-
  1782.           ning placement of screens within a presentation sequence. The
  1783.           screen off feature is important, because in this case, the show
  1784.           command is used simply to get the required screen. If the
  1785.           screen were on, each show command would overlay the existing
  1786.           screen, and windowing would be lost.
  1787.  
  1788.  
  1789.           Presentation Frames
  1790.  
  1791.           The Frame command is most helpful when it is used to organize
  1792.           presentation
  1793.           material. In writing scripts for a presentation, you will find
  1794.           it best to
  1795.           offset the Frame command slightly from the rest of the com-
  1796.           mands, for easy
  1797.           identification of sequences:
  1798.  
  1799.                     frame
  1800.                       show file1
  1801.                     frame
  1802.                       show file2 0
  1803.                       left file3
  1804.                       left file4
  1805.                     frame
  1806.                       clear
  1807.                       color 1 3
  1808.                       show file5
  1809.                     frame
  1810.  
  1811.           By allowing movement backwards and forwards between sequences
  1812.           ('+' and '-'
  1813.           keys), the frame command also allows you to go back and review
  1814.           material within a presentation. Such repetition works effec-
  1815.           tively as an aid to recall (show-explain-show).
  1816.  
  1817.  
  1818.  
  1819.                                       -- 29 --
  1820.  
  1821.  
  1822.  
  1823.           FLICKER Documentation                                    by Brian J. Dooley
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.            C a r e   i n   P r e p a r a t i o n
  1830.  
  1831.           It is important to bear in mind that the FLICKER program is
  1832.           merely a tool. It is easy to get carried away with computer
  1833.           graphics, because they are fun to create and provide many in-
  1834.           teresting possibilities. FLICKER will contribute to graphics
  1835.           flexibility by providing a powerful projector for image files.
  1836.  
  1837.           In preparing a presentation, always remember that you are at-
  1838.           tempting to make a point--whether it be for sales, for train-
  1839.           ing, or for a business report. The point, not the graphics,
  1840.           must come first. This means that effects should not be used
  1841.           simply to "wow" the audience. There must be a reason for each
  1842.           screen used, and sufficient supporting material to make the
  1843.           point.
  1844.  
  1845.  
  1846.            T e c h n i c a l   N o t e s
  1847.  
  1848.           FLICKER uses graphics files that have been created in the BSAVE
  1849.           format used
  1850.           with Microsoft Basic. In this format, the screen is essentially
  1851.           dumped into a file, which is about 16K in length (there are
  1852.           variations). Graphics programs generally permit this as an op-
  1853.           tion, though it may not be their standard method of saving
  1854.           files. To identify a BSAVE file, simply look for a picture file
  1855.           of 16K or more, since BSAVE options tend to create relatively
  1856.           long files of a standard length.
  1857.  
  1858.           Although it does tend to take up a lot of space, the BSAVE for-
  1859.           mat was used to speed execution and provide immediate (rather
  1860.           than drawn) screens. This was necessary due to the intensive
  1861.           processing required for many of the FLICKER  functions. The
  1862.           built-in file compression functions will enable you to use
  1863.           fewer disks, but unsqueezing a file does take time--so you
  1864.           should continue to use BSAVE files where speed is essential.
  1865.           All animation sequence files should be kept on a RAM disk. Use
  1866.           of a RAM disk provides negligible speed advantages for other
  1867.           functions, since they are processor dependent.
  1868.  
  1869.           The maximum number of command lines that can be included in a
  1870.           FLICKER script is 450; the maximum number of loops is 100; the
  1871.  
  1872.  
  1873.  
  1874.                                       -- 30 --
  1875.  
  1876.  
  1877.  
  1878.           FLICKER Documentation                                    by Brian J. Dooley
  1879.  
  1880.  
  1881.  
  1882.  
  1883.           For those who work within an operating system environment such
  1884.           as TopView or Gem, it should be noted that this program writes
  1885.           directly to screen memory. The speed and effects required made
  1886.           this absolutely necessary.
  1887.  
  1888.  
  1889.            U s e r   S u p p o r t e d   S o f t w a r e
  1890.  
  1891.           FLICKER is distributed under the user supported software con-
  1892.           cept. This means that you are encouraged to copy and distribute
  1893.           this program to others, with the sole proviso that this message
  1894.           be included.
  1895.  
  1896.           If you find this program useful, we request that you send a
  1897.           check for $25 to the following address:
  1898.  
  1899.                                            BRIAN J. DOOLEY
  1900.                                         14 Northgate Village
  1901.                                         Burlington, NJ 08016
  1902.  
  1903.           A contribution of this amount will entitle you to support,
  1904.           notices of new releases, and insure that development of this
  1905.           much-needed software will continue.  In some cases, source
  1906.           code will also be released.
  1907.  
  1908.           To register your copy, complete the following form:
  1909.  
  1910.           Name     __________________________________
  1911.  
  1912.           Phone    ____________________
  1913.  
  1914.           Company  __________________________________
  1915.  
  1916.           Address  __________________________________
  1917.  
  1918.           City     ___________________  State ______________
  1919.  
  1920.           Zip      _______________
  1921.  
  1922.  
  1923.  
  1924.           To guide us in enhancing this software, please also answer the
  1925.           following questions:
  1926.  
  1927.  
  1928.  
  1929.  
  1930.                                       -- 31 --
  1931.  
  1932.  
  1933.  
  1934.           FLICKER Documentation                                    by Brian J. Dooley
  1935.  
  1936.  
  1937.  
  1938.  
  1939.           1.)  In what setting is FLICKER being used ? (Personal,
  1940.           Institutional)
  1941.  
  1942.  
  1943.           _______________________________________________________________
  1944.  
  1945.  
  1946.           2.)  What form of presentation is FLICKER supporting ?
  1947.           (training, educational, in-store display, trade show, etc.)
  1948.  
  1949.  
  1950.           _______________________________________________________________
  1951.  
  1952.  
  1953.           3.)  What software are you using to create your FLICKER image
  1954.                files ?
  1955.  
  1956.  
  1957.           _______________________________________________________________
  1958.  
  1959.  
  1960.           4.)  Are you using the music function ?
  1961.  
  1962.  
  1963.           _______________________________________________________________
  1964.  
  1965.  
  1966.           5.)  What type of plotter/printer do you use?
  1967.  
  1968.  
  1969.           _______________________________________________________________
  1970.  
  1971.  
  1972.           6.)  Do you use an enhanced graphics card ?  If so, which one ?
  1973.  
  1974.  
  1975.           _______________________________________________________________
  1976.  
  1977.  
  1978.           7.)  What features do you feel we should add to this program ?
  1979.  
  1980.  
  1981.           _______________________________________________________________
  1982.  
  1983.  
  1984.  
  1985.                                       -- 32 --
  1986.  
  1987.  
  1988.  
  1989.           FLICKER Documentation                                    by Brian J. Dooley
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.           Thank you. We hope that you enjoy FLICKER, and look forward to
  1996.           serving your needs in future.
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.          ------------------------------------------------------------
  2006.  
  2007.                    This disk copy provided as a service of
  2008.  
  2009.                         The Public (Software) Library
  2010.  
  2011.                            the software library of
  2012.                      The Houston Area League of PC Users
  2013.  
  2014.  
  2015.          For a copy of the latest monthly software library newsletter
  2016.           and a list of the 600+ disks in the library, call or write
  2017.  
  2018.                         The Public (Software) Library
  2019.                                 P.O.Box 35705
  2020.                            Houston, TX 77235-5705
  2021.                                (713) 721-6104
  2022.  
  2023.             Newsletter subscriptions are available for $12 a year.
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.                                       -- 33 --
  2035.  
  2036.  
  2037.